.TH std::shared_ptr::operator[] 3 "2024.06.10" "http://cppreference.com" "C++ Standard Libary"
.SH NAME
std::shared_ptr::operator[] \- std::shared_ptr::operator[]

.SH Synopsis
   element_type& operator[]( std::ptrdiff_t idx ) const;  \fI(since C++17)\fP

   Index into the array pointed to by the stored pointer.

   The behavior is undefined if the stored pointer is null or if idx is negative.

   If T (the template parameter of shared_ptr) is an array type U[N], idx must be less
   than N, otherwise the behavior is undefined.

.SH Parameters

   idx - the array index

.SH Return value

   A reference to the idx-th element of the array, i.e., get()[idx].

.SH Exceptions

   Throws nothing.

   Remarks

   When T is not an array type, it is unspecified whether this function is declared. If
   the function is declared, it is unspecified what its return type is, except that the
   declaration (although not necessarily the definition) of the function is guaranteed
   to be legal.

.SH Example


// Run this code

 #include <cstddef>
 #include <iostream>
 #include <memory>

 int main()
 {
     const std::size_t arr_size = 10;
     std::shared_ptr<int[]> pis(new int[10]{0, 1, 2, 3, 4, 5, 6, 7, 8, 9});
     for (std::size_t i = 0; i < arr_size; ++i)
         std::cout << pis[i] << ' ';
     std::cout << '\\n';
 }

.SH Output:

 0 1 2 3 4 5 6 7 8 9

.SH See also

   get returns the stored pointer
       \fI(public member function)\fP
